home *** CD-ROM | disk | FTP | other *** search
/ Total Network Tools 2002 / NextStepPublishing-TotalNetworkTools2002-Win95.iso / Archive / Web Server / Xitami Multithreaded Web Server.exe / XITAMI.CFG < prev    next >
Encoding:
Text File  |  2000-04-01  |  63.2 KB  |  1,710 lines
  1. #
  2. #   xitami.cfg - Xitami configuration file
  3. #
  4. #   Generated: 2000/04/01 16:28:47
  5. #
  6. #   This file is produced automatically using GSLgen through the Xitami
  7. #   configurator.  You can print it if you need a textual reference to the
  8. #   Xitami configuration options, although the HTML version is easier to use.
  9. #
  10. #   DON'T MODIFY THIS FILE... instead, create a file called 'defaults.cfg'
  11. #   with the sections and entries you need.  If you modify this file, any
  12. #   changes WON'T BE SHOWN in the browser-based admin screens.  Okay, we
  13. #   warned you.
  14. #
  15. #*END
  16. #   -------------------------------------------------------------------------
  17. #   SERVER configuration section
  18. #
  19. #   This section defines general parameters for the web server. 
  20.  
  21. [Server]
  22. #   Specifies the directory root where web pages are located. This can 
  23. #   be an absolute directory or a relative directory. 
  24.  
  25.     webpages=./webpages
  26.  
  27. #   Specifies the directory where CGI programs are located. This can 
  28. #   be an absolute directory (starting with '/' or '\', if you prefer) 
  29. #   or a relative directory (not starting with '/' or '\'). 
  30.  
  31.     cgi-bin=./cgi-bin
  32.  
  33. #   Specifies the string that Xitami uses to detect that a URL is to 
  34. #   be treated as a CGI. This value must start with '/', and can 
  35. #   consist of one or more paths. For instance: '/cgi', '/script', 
  36. #   '/scripts/cgi'. This string does not actually refer to a real disk 
  37. #   directory; it is translated into a real filename using the cgi-bin 
  38. #   option, and a heuristic. 
  39.  
  40.     cgi-url=/cgi-bin
  41.  
  42. #   Specifies the delay in seconds between each server refresh. At 
  43. #   each refresh, the server does a number of administrative tasks: 
  44. #   reload the configuration file if changed; reopen the file 
  45. #   xitami.aut in any case; cycle the log files if necessary. The 
  46. #   refresh rate has a minimum of 10 seconds, unless it is set to 0 in 
  47. #   which case no refresh occurs at all. (This can be used to 
  48. #   determine if the refresh is causing sporadic problems.) 
  49.  
  50.     refresh=60
  51.  
  52. #   If 1, the server creates various debugging log files. The file 
  53. #   request.log contains every incoming request. The file 'debug.log' 
  54. #   in particular logs the processing of the requests. The file 
  55. #   'header.log' contains every response sent back to the browser. Use 
  56. #   this to debug a virtual host configuration that gives problems, or 
  57. #   to determine the cause of a recurrent problem. 
  58.  
  59.     debug=0
  60.  
  61. #   Specifies a directory for debug log files. Xitami interprets this 
  62. #   value as an environment variable if possible, else as a literal 
  63. #   directory name. If you want it to refer only to a directory name, 
  64. #   end it in '/'. 
  65.  
  66.     debug-dir=debug
  67.  
  68. #   Specifies a directory for temporary files. The server creates 
  69. #   these to pass information to and from CGI programs, and if 
  70. #   debugging is enabled, you may find that these accumulate. Xitami 
  71. #   interprets this value as an environment variable if possible, else 
  72. #   as a literal directory name. If you want it to refer only to a 
  73. #   directory name, end it in '/'. 
  74.  
  75.     temp-dir=temp
  76.  
  77. #   Specifies the directory for log files. This option applies to all 
  78. #   log files that Xitami creates, except debug log files. You can 
  79. #   leave this option empty, and specify a full path name for each log 
  80. #   file: this allows you to put different log files where you like. 
  81.  
  82.     log-dir=./logs
  83.  
  84. #   Specifies the directory for header files. Header files contain 
  85. #   custom HTTP headers, used for all files of some type. For 
  86. #   instance, you can ask Xitami to output the HTTP header 
  87. #   'Cache-Control: no-cache' for all files with the extension '.txt' 
  88. #   by creating a file called 'header.txt' in this directory, and 
  89. #   containing the HTTP header line. Each header file matches all 
  90. #   files with the same extension. 
  91.  
  92.     header-dir=./headers
  93.  
  94. #   Specifies the maximum number of concurrent HTTP connections. On 
  95. #   systems that can handle lots of open sockets (e.g. Unix, OS/2, 
  96. #   WinNT, Win98), you may want to set this high. Xitami does not 
  97. #   impose any fixed limit. If you set this value to 0, it means 'no 
  98. #   limit'. 
  99.  
  100.     limit=0
  101.  
  102. #   Specifies the HTTP throttle pipe. With a throttle pipe you can 
  103. #   restrict the throughput of a website to some fixed maximum, e.g. 
  104. #   64Kbps. This can be useful if several websites share a single 
  105. #   line, and you need to share this on a quality-of-service basis. 
  106. #   The HTTP throttle pipe is applied to all download and upload 
  107. #   requests to the website. You can apply a throttle pipe to the 
  108. #   entire HTTP server or to specific virtual hosts. Pipes are defined 
  109. #   in the XML file 'pipedef.xml'. You can edit this file to add new 
  110. #   pipes; Xitami reloads this automatically after a short delay. Each 
  111. #   pipe is defined as several 'instances', which are simply 
  112. #   individual pipes that share the same characteristics. For example, 
  113. #   the default pipedef.xml file defines several pipes with a 64Kbps 
  114. #   throughput. These are individual instances of a 64Kpbs pipe. All 
  115. #   transfers that use a specific pipe instance share the bandwidth of 
  116. #   that pipe instance. 
  117.  
  118.     pipe=
  119.  
  120. #   Specifies the throttle pipe definition file. This is an XML file 
  121. #   that follows a specific format - look at pipedef.xml for an 
  122. #   explanation. If you define your own throttle pipes, it's a good 
  123. #   idea to copy pipedef.xml to something else (e.g. 'mypipes.xml') 
  124. #   and then change that. This avoids unpleasant surprises when you 
  125. #   upgrade your Xitami version. Note that we may change the format of 
  126. #   the pipe definition file in the future. 
  127.  
  128.     pipedef=pipedef.xml
  129.  
  130. #   If 1, the server runs as a background process, on operating 
  131. #   systems that support this functionality. If 0, the server runs as 
  132. #   a foreground process. Background processes are detached from their 
  133. #   controlling terminal and must be halted by a system 'kill process' 
  134. #   request. Foreground processes send their output to the controlling 
  135. #   terminal and can be halted by an interrupt key (e.g. Ctrl-C). 
  136. #   Currently, only implemented on UNIX systems. 
  137.  
  138.     background=0
  139.  
  140. #   If 1, the server will run even if it cannot open the HTTP port. It 
  141. #   will retry every 5 seconds until you stop the server (which must 
  142. #   be done manually if the HTTP service cannot start). The autostart 
  143. #   option applies both to the HTTP and the FTP service. This option 
  144. #   is useful for systems where the network is not initially active, 
  145. #   but comes 'up' after some action (e.g. dialing-up). Currently it 
  146. #   is implemented only in the 32-bit Windows version of Xitami, 
  147. #   mostly because this is the only platform that actually needs it. 
  148.  
  149.     autostart=0
  150.  
  151. #   If 1, the server will try to recover from fatal errors using an 
  152. #   internal crash recovery system. This currently only works under 
  153. #   Windows. When this option is 0, Xitami will show a fatal error 
  154. #   message and (under Windows) allow the web administrator to 
  155. #   continue. 
  156.  
  157.     recover=0
  158.  
  159. #   Specifies the sort order for directory listings. You can sort by 
  160. #   file name, extension, size, or modification date/time using any 
  161. #   combination of the letters 'n', 'x', 's', and 't'. For instance, 
  162. #   dirsort=xnt will sort by extension, then name, then time. To sort 
  163. #   in reverse order, use capital letters. For instance to show the 
  164. #   most recent files first, use dirsort=T. 
  165.  
  166.     dirsort=n
  167.  
  168. #   Specifies the GSL script that is used to format HTTP directory 
  169. #   listings. GSL is a scripting language used by the iMatix GSLgen 
  170. #   tool, incorporated into Xitami. A GSL script is a flexible way to 
  171. #   format output texts - see the supplied script for more 
  172. #   information. It's a good idea, if you change this script, to copy 
  173. #   it and change the copy. Otherwise your changes will probably be 
  174. #   lost when/if you ever upgrade your Xitami installation. 
  175.  
  176.     dir-script=templates/httpdir.gsl
  177.  
  178. #   Enables or disables the supervisor agent. When enabled, the 
  179. #   supervisor agent will regularly check for old log files and 
  180. #   temporary files, and remove these. Temporary files are deleted 
  181. #   when they are over one day old, and log files are deleted when 
  182. #   they are more than two weeks old. 
  183.  
  184.     supervisor=0
  185.  
  186. #   If 1, Xitami will allow browsers that support the Keep-Alive 
  187. #   protocol to carry-out multiple requests on a single connection. 
  188. #   This can improve performance, especially on pages with very many 
  189. #   small files. If 0, the browser creates a new connection for each 
  190. #   HTTP request. 
  191.  
  192.     keep-alive=1
  193.  
  194. #   A number greater than 1; Xitami will allow this many requests on 
  195. #   an 'alive' connection before closing it. Setting this to 1 has the 
  196. #   same effect as setting keep-alive to 0. 
  197.  
  198.     keep-alive-max=50
  199.  
  200. #   A 'kept-alive' connection will last this long before Xitami closes 
  201. #   it. The timeout is specified in seconds. You can actually put this 
  202. #   value quite high if wanted: the cost of an open connection is low 
  203. #   and does not degrade the server performance. Anything more than a 
  204. #   minute or so is probably not worth it. 
  205.  
  206.     timeout=30
  207.  
  208. #   Specifies the default files. Up to 32 default files can be 
  209. #   specified. When the user specifies a URL without filename, the 
  210. #   server searches the directory for the default files, in order, 
  211. #   from default1 to default32, until a matching file is found or the 
  212. #   default sequence ends. Note that Xitami automatically looks for 
  213. #   .html extensions if a .htm file is not found. 
  214.  
  215.     default1=index.htm
  216.  
  217. #   Specifies the default files. Up to 32 default files can be 
  218. #   specified. When the user specifies a URL without filename, the 
  219. #   server searches the directory for the default files, in order, 
  220. #   from default1 to default32, until a matching file is found or the 
  221. #   default sequence ends. Note that Xitami automatically looks for 
  222. #   .html extensions if a .htm file is not found. 
  223.  
  224.     default2=default.htm
  225.  
  226. #   Normally, defaults pages are cached like any other. This means 
  227. #   that if the browser has already loaded the page, it will add a 
  228. #   HTTP request header 'If-Modified-Since'. Xitami uses this date to 
  229. #   determine whether to send the page or not. In most cases, it is 
  230. #   appropriate to leave this option enabled. However, if you are 
  231. #   developing several sites, you may find that the browser shows the 
  232. #   default page from one site when you look at another. You can clear 
  233. #   the browser cache and reload, but this is usually pretty tiresome. 
  234. #   To fix this disable this option and Xitami will never cache 
  235. #   defaults pages. 
  236.  
  237.     cache-defaults=1
  238.  
  239. #   Specifies whether you want to use an error script or not. When 
  240. #   enabled, Xitami will pass all HTTP errors to the specified GSL 
  241. #   script for processing. This is an easy and powerful way to 
  242. #   customise error messages in a single place. By default this is 
  243. #   disabled, for compatability with earlier releases of Xitami, but 
  244. #   an error script is supplied as standard, and used if you enable 
  245. #   this option. 
  246.  
  247.     use-error-script=0
  248.  
  249. #   Specifies the GSL script that is used to format HTTP error 
  250. #   messages. If you use this option, Xitami ignores error-header, 
  251. #   text-xxx, and error-footer options. GSL is a scripting language 
  252. #   used by the iMatix GSLgen tool, incorporated into Xitami. A GSL 
  253. #   script is a flexible way to format output texts - see the supplied 
  254. #   script for more information. It's a good idea, if you change this 
  255. #   script, to copy it and change the copy. Otherwise your changes 
  256. #   will probably be lost when/if you ever upgrade your Xitami 
  257. #   installation. 
  258.  
  259.     error-script=templates/errors.gsl
  260.  
  261. #   Specifies the text used to preface an HTTP error message. The text 
  262. #   may either be HTML, or a filename prefaced by '@'. If the text 
  263. #   comes from a file, Xitami will re-read this file each time it 
  264. #   sends an error response. 
  265.  
  266.     error-header=@errors/header.htm
  267.  
  268. #   Specifies the text used to end an HTTP error message. The text may 
  269. #   either be HTML, or a filename prefaced by '@'. If the text comes 
  270. #   from a file, Xitami will re-read this file each time it sends an 
  271. #   error response. 
  272.  
  273.     error-footer=@errors/footer.htm
  274.  
  275. #   Specifies the text used for the HTTP error 'Bad request'. This 
  276. #   text can either be HTML, or be a filename prefaced by '@'. The 
  277. #   text is always prefixed by the error header and suffixed by the 
  278. #   error footer. 
  279.  
  280.     text-400=@errors/text-400.htm
  281.  
  282. #   Specifies the text used for the HTTP error 'Unauthorized'. 
  283.  
  284.     text-401=@errors/text-401.htm
  285.  
  286. #   Specifies the text used for the HTTP error 'Payment required'. 
  287.  
  288.     text-402=@errors/text-402.htm
  289.  
  290. #   Specifies the text used for the HTTP error 'Forbidden'. 
  291.  
  292.     text-403=@errors/text-403.htm
  293.  
  294. #   Specifies the text used for the HTTP error 'Not found'. 
  295.  
  296.     text-404=@errors/text-404.htm
  297.  
  298. #   Specifies the text used for the HTTP error 'Precondition failed'. 
  299.  
  300.     text-412=@errors/text-412.htm
  301.  
  302. #   Specifies the text used for the HTTP error 'Request entity too 
  303. #   large'. 
  304.  
  305.     text-413=@errors/text-413.htm
  306.  
  307. #   Specifies the text used for the HTTP error 'Internal error'. 
  308.  
  309.     text-500=@errors/text-500.htm
  310.  
  311. #   Specifies the text used for the HTTP error 'Not implemented'. 
  312.  
  313.     text-501=@errors/text-501.htm
  314.  
  315. #   Specifies the text used for the HTTP error 'Service temporarily 
  316. #   overloaded'. 
  317.  
  318.     text-502=@errors/text-502.htm
  319.  
  320. #   Specifies the server priority, on systems where this is possible 
  321. #   (currently only Windows NT and 95). 1=normal, 2=low, 3=high. You 
  322. #   can set the priority to 'low' for systems where the server should 
  323. #   not interfere with other processes. You can set the priority to 
  324. #   'high' for systems where the server is the main process. 
  325.  
  326.     priority=1
  327.  
  328. #   Specifies the IP address on which Xitami should open its HTTP 
  329. #   connection. If this is *, Xitami will open its connection on all 
  330. #   available IP addresses. This is normally a Good Idea, since it 
  331. #   makes configuration much simpler on a multihomed system, and is 
  332. #   completely correct on a single-homed system (i.e. a system with 
  333. #   just one IP address, which is pretty common). If you have multiple 
  334. #   IP addresses and want to run Xitami on just one of these, you can 
  335. #   specify it here using the standard dotted network address format. 
  336. #   This will effectively disable IP-based virtual hosting. 
  337.  
  338.     ipaddress=*
  339.  
  340. #   Defines the IP port base for the server. Add 80 to this to 
  341. #   calculate the actual port used for the HTTP service. For example, 
  342. #   to run the server on port 6080, define portbase as 6000. We use a 
  343. #   portbase in place of an absolute address so that multiple 
  344. #   protocols (e.g. the FTP server embedded into Xitami) can be 
  345. #   managed as one unit. 
  346.  
  347.     portbase=0
  348.  
  349. #   Specifies the name of the configuration file used for the base 
  350. #   virtual host. You may need this option when you have virtual hosts 
  351. #   that all inherit values from defaults.cfg, but where the base host 
  352. #   needs different values. 
  353.  
  354.     base-host=basehost.cfg
  355.  
  356. #   Specifies your fully-qualified domain name for the server. This 
  357. #   name is used whenever the server needs to redirect a request (e.g. 
  358. #   for image maps). You may want to provide this when configuring a 
  359. #   virtual host. It is not usually necessary on single-hosted 
  360. #   systems. The default for this value is the system host name, or 
  361. #   virtual host name for virtual hosts. 
  362.  
  363.     hostname=
  364.  
  365. #   Specifies the name of the local configuration file. This file 
  366. #   provides the defaults that are used for all virtual hosts. 
  367. #   Anything in the defaults file overrides the contents of 
  368. #   xitami.cfg. 
  369.  
  370.     defaults=defaults.cfg
  371.  
  372.  
  373. #   -------------------------------------------------------------------------
  374. #   ALIAS configuration section
  375. #
  376. #   This section lets you define HTTP aliases. An alias is a virtual 
  377. #   directory that points to some arbitrary directory on the server 
  378. #   computer. This can be outside the normal webpages directory, e.g. 
  379. #   on another drive. Aliases can be structured into multiple levels, 
  380. #   e.g. /pub and /pub/documents can both be defined as individual 
  381. #   aliases. HTTP aliases always come at the start of the URL. An HTTP 
  382. #   alias can also refer to a complete filename, in which case that 
  383. #   file will act as the default file for the alias. To define an 
  384. #   alias, specify the alias name and the directory it refers to. 
  385.  
  386. [Alias]
  387.  
  388. #   -------------------------------------------------------------------------
  389. #   VIRTUAL-HOSTS configuration section
  390. #
  391. #   This section lets you define virtual hosts. A virtual host can be 
  392. #   specified in two ways: by IP address (if your system has multiple 
  393. #   IP addresses) or by name (if your system has multiple names). To 
  394. #   define a virtual host, specify the virtual IP address or host name 
  395. #   and the name of a configuration file . 
  396.  
  397. [Virtual-Hosts]
  398.  
  399. #   -------------------------------------------------------------------------
  400. #   FILTER configuration section
  401. #
  402. #   This section lets you define filter programs. To define a filter, 
  403. #   specify a file extension with a leading dot and the filter 
  404. #   command. The command may be with a full path, or without, if the 
  405. #   program is on the PATH. 
  406.  
  407. [Filter]
  408.  
  409. #   -------------------------------------------------------------------------
  410. #   CGI configuration section
  411. #
  412. #   This section controls the CGI protocol. 
  413.  
  414. [Cgi]
  415. #   Allows you to disable CGI handling in one stroke. If this is 1, 
  416. #   URLs that translate to a CGI are allowed. If this is 0, URLs that 
  417. #   translate to a CGI are rejected with a code 501 (Not implemented). 
  418.  
  419.     enabled=1
  420.  
  421. #   Defines the directory where CGI programs will run. The web server 
  422. #   must have write access to this directory. You can tell Xitami to 
  423. #   always use the script directory by specifying "-". (This is useful 
  424. #   if you put scripts in various subdirectories.) This option applies 
  425. #   to filters too. 
  426.  
  427.     workdir=-
  428.  
  429. #   Defines whether the CGI URL indicator ('/cgi-bin') is allowed 
  430. #   anywhere in the URL, or only at the start. If 1, it is allowed 
  431. #   anywhere in the URL. If 0, it may come only at the start of the 
  432. #   URL. Note that setting this to 1 opens a significant security 
  433. #   hole, if you also allow people to FTP files into the HTTP area. As 
  434. #   soon as someone creates a directory called /cgi-bin, they can 
  435. #   upload, and execute, CGI programs. In some configurations this is 
  436. #   desirable. In other configurations (e.g. if you allow your users 
  437. #   to upload CGI scripts, or if you do not do FTP uploads into the 
  438. #   HTTP space) it can be desirable. 
  439.  
  440.     wildcard=0
  441.  
  442. #   The maximum time, in seconds, that a CGI program may run. This 
  443. #   option prevents looping CGI programs from blocking the server 
  444. #   system for more than a short period. However, you will want to 
  445. #   tune it if you run exceptionally slow CGIs, e.g. large database 
  446. #   searches. (Which we do not recommend; you should always aim for a 
  447. #   response time of less than 2 seconds, and 5 seconds for 'heavy' 
  448. #   processing.) If you set this to zero, Xitami lets CGIs run for an 
  449. #   arbitrarily long time (actually one hour) before killing them. 
  450.  
  451.     timeout=60
  452.  
  453. #   The frequency, in milliseconds, at which Xitami monitors the 
  454. #   progress of CGI programs. If you raise this time to 500, for 
  455. #   example, Xitami will check the CGI program's progress every 1/2 
  456. #   second. Anything less than 100 is not a good idea, probably, since 
  457. #   it will slow-down the server. 
  458.  
  459.     monitor=200
  460.  
  461. #   If 1, the server will generate a directory listing for any URL 
  462. #   that refers to a CGI directory not containing a default file. If 
  463. #   0, such accesses result in a 403 Forbidden response. 
  464.  
  465.     dirlist=0
  466.  
  467. #   If 1, CGI programs and scripts get all filenames passed through 
  468. #   the environment and on the command line in MS-DOS format (using 
  469. #   backslashes); otherwise they get filenames in Unix format (using 
  470. #   forward slashes). 
  471.  
  472.     msdos-style=0
  473.  
  474. #   If 1, the server creates files containing the CGI input and output 
  475. #   streams, called tmpxxxxx.cgi and tmpxxxxx.cgo. You can use these 
  476. #   to debug CGI programs' output. 
  477.  
  478.     debug=0
  479.  
  480. #   If 1, the server uses standard input/output streams to pass CGI 
  481. #   input and output data. This is suitable for languages such as C, 
  482. #   Perl, etc. that have access to stdin and stdout streams. When 
  483. #   using languages that cannot read from stdin or write to stdout, 
  484. #   you must set this value to 0, and refer to the CGI_STDIN and 
  485. #   CGI_STDOUT environment variables. 
  486.  
  487.     stdio=1
  488.  
  489. #   If 1, allows images, HTML, and other files in the cgi-bin 
  490. #   directory. The CGI program can refer to these using relative 
  491. #   addressing. If 0, such files are not permitted. Note that in any 
  492. #   case, executable files (such as Perl scripts) are always executed, 
  493. #   never downloaded. 
  494.  
  495.     mixed-url=1
  496.  
  497. #   Specifies a filename for output of CGI program errors. A CGI 
  498. #   program can send error messages to the stderr stream; these are 
  499. #   captured in this log file. 
  500.  
  501.     errlog=cgierr.log
  502.  
  503. #   If 1, the CGI program gets the full web server environment, 
  504. #   including values such as PATH. If 0, does not have access to such 
  505. #   data. The environment data can assist a hostile attack on the host 
  506. #   system. 
  507.  
  508.     environment=1
  509.  
  510. #   If 1, the server will pass URL arguments (?arg1+arg2+...)to CGI 
  511. #   programs. If 0, these are not passed. Under some systems, this can 
  512. #   pose a security problem if devious hackers manage to pass 
  513. #   arguments to shell scripts that are interpreted as commands or 
  514. #   filters. In any case, Xitami replaces these 'dangerous' 
  515. #   characters: |, >, < by spaces. 
  516.  
  517.     passargs=0
  518.  
  519. #   Defines whether the HTTP request header fields are passed to the 
  520. #   CGI program or not. 
  521.  
  522.     http-fields=1
  523.  
  524. #   Specifies the prefix used to identify HTTP header fields in the 
  525. #   CGI program environment. Note that this should be different from 
  526. #   the form-prefix, so that there is no chance of an overlap in field 
  527. #   names. To specify 'no prefix', use http-prefix="". 
  528.  
  529.     http-prefix=HTTP_
  530.  
  531. #   If 1, the form data (coming from a GET or POST method) is supplied 
  532. #   as environment variables. This can be required by some CGI 
  533. #   programs. However, when large forms are used, this may cause the 
  534. #   environment to be over-filled. Since the form data is also 
  535. #   available to the CGI program on its standard input device, it can 
  536. #   be useful to set this option to 0. 
  537.  
  538.     form-fields=1
  539.  
  540. #   Specifies the prefix used to identify form data fields in the CGI 
  541. #   program environment. To specify 'no prefix', use form-prefix="". 
  542.  
  543.     form-prefix=FORM_
  544.  
  545. #   If 1, the form data (coming from a POST method) is supplied as the 
  546. #   environment variable QUERY_STRING. If 0, this data is supplied as 
  547. #   separate environment variables, and on the standard input device 
  548. #   but not as a QUERY_STRING environment variable. Some CGI products 
  549. #   (we know of Progress Webspeed) will barf if this is turned-on, 
  550. #   since they do not expect input in both this string and on stdin. 
  551.  
  552.     form-query=0
  553.  
  554.  
  555. #   -------------------------------------------------------------------------
  556. #   CGI-ENVIRONMENT configuration section
  557. #
  558. #   This section lets you define specific CGI environment variables. 
  559. #   Each definition is taken literally and passed to the CGI program. 
  560. #   This can be useful when using virtual hosts. 
  561.  
  562. [Cgi-Environment]
  563.  
  564. #   -------------------------------------------------------------------------
  565. #   CGI-ALIAS configuration section
  566. #
  567. #   This section lets you define CGI aliases. A CGI alias is a virtual 
  568. #   directory that points to some arbitrary directory on the server 
  569. #   computer and contains CGI scripts or programs. This combines the 
  570. #   functions of the CGI url '/cgi-bin' and an HTTP alias. To define a 
  571. #   CGI alias, specify the alias name and the directory it refers to. 
  572.  
  573. [Cgi-Alias]
  574.  
  575. #   -------------------------------------------------------------------------
  576. #   SSI configuration section
  577. #
  578. #   This section controls Xitami's built-in server-side includes (SSI) 
  579. #   handling. 
  580.  
  581. [Ssi]
  582. #   Lets you enable/disable SSI handling. 
  583.  
  584.     enabled=1
  585.  
  586. #   Specifies the format for times shown by SSI pages. 
  587.  
  588.     timefmt=%A, %d-%b-%y %H:%M:%S %Z
  589.  
  590. #   Specifies whether size should be shown as bytes or as 
  591. #   abbreviations (Kb, Mg). Anything other than the string "bytes" is 
  592. #   taken to mean that sizes are shown as abbreviations. 
  593.  
  594.     sizefmt=bytes
  595.  
  596. #   The timeout for CGI programs called from the SSI agent. 
  597.  
  598.     timeout=30
  599.  
  600. #   Error message shown when an SSI command fails. The %s symbol is 
  601. #   replaced by the cause of the problem. 
  602.  
  603.     errmsg=<p>[xitami SSI: %s]
  604.  
  605. #   If 1, allows CGIs to be executed using the #exec command. Since 
  606. #   this is a security weakness, this option is switched-off by 
  607. #   default. 
  608.  
  609.     exec=0
  610.  
  611.  
  612. #   -------------------------------------------------------------------------
  613. #   SECURITY configuration section
  614. #
  615. #   This section defines HTTP server security options. 
  616.  
  617. [Security]
  618. #   Specifies the Basic Authentication file. 
  619.  
  620.     filename=xitami.aut
  621.  
  622. #   If 1, passwords are case-sensitive. If 0, passwords are always 
  623. #   converted to lower-case before validation. If you set this to 0, 
  624. #   be sure to use lower-case passwords in the password file. 
  625.  
  626.     password-case=1
  627.  
  628. #   If 1, the server will generate a directory listing for any URL 
  629. #   that refers to a directory not containing a default file. If 0, 
  630. #   such accesses result in a 403 Forbidden response. If the directory 
  631. #   URL is followed by '?sort=', then the following string is used to 
  632. #   sort the directory, and override the dirsort option. For instance: 
  633. #   'http://www.imatix.com/pub/xitami/?sort=T'. 
  634.  
  635.     dirlist=1
  636.  
  637. #   If 1, the server will allow access to the web-based administration 
  638. #   pages (WBA). If 0, the WBA agent will not be started. This is a 
  639. #   safe way to disable WBA access, for sites where this is not needed 
  640. #   and poses a potential security hole. 
  641.  
  642.     admin=1
  643.  
  644. #   Specifies the Superuser password. If this is "" or "-", no 
  645. #   superuser access is allowed. Anything else is accepted as a 
  646. #   password for all protected resources, including the online 
  647. #   administration functions. This password overrides the webmask for 
  648. #   any resource. So, be really careful. It does not override the 
  649. #   webmask for the entire server. 
  650.  
  651.     superuser=
  652.  
  653. #   If 1, the server will refuse access to 'unsafe' URLs, which is a 
  654. #   notion that Microsoft invented when they allowed the same file to 
  655. #   have a short and a long filename. When this is enabled, Xitami 
  656. #   rejects any URLs that contain a directory name which can be 
  657. #   translated to a different long name and the user receives a 403 
  658. #   error message. If 0, this check is not done. 
  659.  
  660.     safepaths=1
  661.  
  662. #   Limits the set of clients that can connect to the HTTP server. 
  663. #   This provides an easy way of creating an extranet web service - 
  664. #   you can put your server on the Internet, but allow access to a 
  665. #   fixed set of IP addresses. Use 'webmask=local' to specify just 
  666. #   local addresses, or 'webmask=item,item,...' to specify one or more 
  667. #   types of access. Each item allows or excludes some IP address(es): 
  668. #   '250.12.13.*' allows matching addresses, '!250.12.13.*' excludes 
  669. #   matching addresses (but does not allow others). '!250.12.13.*,*' 
  670. #   excludes one set of addresses and allows all others. 
  671. #   'webmask=@iplist.txt' reads the list of webmasks from a text file. 
  672.  
  673.     webmask=*
  674.  
  675. #   Specifies whether the server switches to a safe user id and group 
  676. #   at startup. This only works under Unix systems. When you use this 
  677. #   option, you can be certain that the server runs with the minimum 
  678. #   necessary privileges. 
  679.  
  680.     setuid=0
  681.  
  682. #   When the security:setuid option is enabled, switches to this user 
  683. #   id after opening its HTTP and FTP ports. You should ensure that 
  684. #   the user id exists and has suitable authority to write to log 
  685. #   files, etc. 
  686.  
  687.     setuid-user=nobody
  688.  
  689. #   When the security:setuid option is enabled, switches to this group 
  690. #   id after opening its HTTP and FTP ports. You should ensure that 
  691. #   the group id exists and has suitable authority to write to log 
  692. #   files, etc. If you set this option to an empty value, e.g. "", 
  693. #   Xitami does not change the group id. 
  694.  
  695.     setuid-group=nogroup
  696.  
  697. #   Specifies the username under which CGIs will be run. If blank, 
  698. #   runs under the same user id as started Xitami. 
  699.  
  700.     cgi-username=
  701.  
  702. #   Specifies a password to start CGIs under the specified user id. 
  703. #   This is required under Windows only. 
  704.  
  705.     cgi-password=
  706.  
  707. #   Specifies the group name under which CGIs will be run. If blank, 
  708. #   runs under the same group name as started Xitami. 
  709.  
  710.     cgi-groupname=
  711.  
  712.  
  713. #   -------------------------------------------------------------------------
  714. #   SERVERLOG configuration section
  715. #
  716. #   This section controls the server error and information log. 
  717.  
  718. [Serverlog]
  719. #   Specifies whether server logging is enabled or not. 
  720.  
  721.     enabled=1
  722.  
  723. #   Specifies the name of the server log file. 
  724.  
  725.     filename=xitami.log
  726.  
  727. #   Specifies when to cycle the log file. When Xitami cycles a log 
  728. #   file, it first moves or copies the existing data to another file, 
  729. #   then creates a new, empty log file. 
  730.  
  731.     cycle=daily
  732.  
  733. #   Specifies how to cycle the log file. 
  734.  
  735.     cycle-how=rename
  736.  
  737. #   Specifies the time of day, or minute past the hour, that the log 
  738. #   file is cycled. 
  739.  
  740.     cycle-time=00:00
  741.  
  742. #   Specifies the day of the week or month that the log file is 
  743. #   cycled. 
  744.  
  745.     cycle-day=0
  746.  
  747. #   Specifies the maximum size in Kbytes for the log file; after that 
  748. #   it is cycled. 
  749.  
  750.     cycle-size=0
  751.  
  752. #   Specifies the maximum size in lines for the log file; after that 
  753. #   it is cycled. 
  754.  
  755.     cycle-lines=0
  756.  
  757. #   Specifies an argument used for the various cycle-how options. When 
  758. #   renaming a file or concatenating it onto another, Xitami uses the 
  759. #   argument as a time-stamped filename. When moving the file, Xitami 
  760. #   uses the argument as a time-stamped directory name. When 
  761. #   processing the file through an arbitrary command, it uses the 
  762. #   argument as a time-stamped command string. Xitami does not use the 
  763. #   argument when deleting log files. Format this argument from any of 
  764. #   the following timestamp fiels, mixed with other text. 
  765.  
  766.     cycle-arg=xi%yy%mm%dd.log
  767.  
  768.  
  769. #   -------------------------------------------------------------------------
  770. #   ACCESSLOG configuration section
  771. #
  772. #   This section controls the server access log, recording HTTP hits. 
  773.  
  774. [Accesslog]
  775. #   Specifies whether logging is enabled or not. 
  776.  
  777.     enabled=1
  778.  
  779. #   Specifies the name of the log file. 
  780.  
  781.     filename=access.log
  782.  
  783. #   Specifies whether to include local addresses or not. 
  784.  
  785.     local=1
  786.  
  787. #   Specifies the log file format. The log file format you use needs 
  788. #   to be compatible with whatever tool you use to analyze log files 
  789. #   and build statistics. The most common tools work with an extended 
  790. #   form of the NCSA log file format, also called 'common log file 
  791. #   format'. We call this "CLFX". An other commonly-used format is 
  792. #   that produced by Microsoft web servers. Xitami also creates log 
  793. #   files in two XML formats, which you can easily process using 
  794. #   GSLgen to you create arbitrary reports, statistics, and HTML 
  795. #   analyses. Lastly, you can create your own format, for specific 
  796. #   purposes. Impressed? We are... :-) 
  797.  
  798.     format=CLFX
  799.  
  800. #   Custom log file format. This is an arbitrary text string that 
  801. #   contains symbols as listed below. Symbols are enclosed by $\( and 
  802. #   ) in the string. 
  803.  
  804.     custom=
  805.  
  806. #   Specifies whether to do reverse-DNS translations of the logged IP 
  807. #   addresses, or not. Reverse-DNS translation can take some time, and 
  808. #   if you need log file data quickly, leave this disabled. Enabling 
  809. #   reverse-DNS translations will not slow- down Xitami. 
  810.  
  811.     translate=0
  812.  
  813. #   Specifies when to cycle the log file. When Xitami cycles a log 
  814. #   file, it first moves or copies the existing data to another file, 
  815. #   then creates a new, empty log file. 
  816.  
  817.     cycle=daily
  818.  
  819. #   Specifies how to cycle the log file. 
  820.  
  821.     cycle-how=rename
  822.  
  823. #   Specifies the time of day, or minute past the hour, that the log 
  824. #   file is cycled. 
  825.  
  826.     cycle-time=00:00
  827.  
  828. #   Specifies the day of the week or month that the log file is 
  829. #   cycled. 
  830.  
  831.     cycle-day=0
  832.  
  833. #   Specifies the maximum size in Kbytes for the log file; after that 
  834. #   it is cycled. 
  835.  
  836.     cycle-size=0
  837.  
  838. #   Specifies the maximum size in lines for the log file; after that 
  839. #   it is cycled. 
  840.  
  841.     cycle-lines=0
  842.  
  843. #   Specifies an argument used for the various cycle-how options. When 
  844. #   renaming a file or concatenating it onto another, Xitami uses the 
  845. #   argument as a time-stamped filename. When moving the file, Xitami 
  846. #   uses the argument as a time-stamped directory name. When 
  847. #   processing the file through an arbitrary command, it uses the 
  848. #   argument as a time-stamped command string. Xitami does not use the 
  849. #   argument when deleting log files. Format this argument from any of 
  850. #   the following timestamp fiels, mixed with other text. 
  851.  
  852.     cycle-arg=ac%yy%mm%dd.log
  853.  
  854.  
  855. #   -------------------------------------------------------------------------
  856. #   ERRORLOG configuration section
  857. #
  858. #   This section controls the server error log, recording HTTP errors. 
  859.  
  860. [Errorlog]
  861. #   Specifies whether logging is enabled or not. 
  862.  
  863.     enabled=1
  864.  
  865. #   Specifies the name of the log file. 
  866.  
  867.     filename=errors.log
  868.  
  869. #   Specifies whether to include local addresses or not. 
  870.  
  871.     local=1
  872.  
  873. #   Specifies the log file format. The log file format you use needs 
  874. #   to be compatible with whatever tool you use to analyze log files 
  875. #   and build statistics. The most common tools work with an extended 
  876. #   form of the NCSA log file format, also called 'common log file 
  877. #   format'. We call this "CLFX". An other commonly-used format is 
  878. #   that produced by Microsoft web servers. Xitami also creates log 
  879. #   files in two XML formats, which you can easily process using 
  880. #   GSLgen to you create arbitrary reports, statistics, and HTML 
  881. #   analyses. Lastly, you can create your own format, for specific 
  882. #   purposes. Impressed? We are... :-) 
  883.  
  884.     format=CLFX
  885.  
  886. #   Custom log file format. This is an arbitrary text string that 
  887. #   contains symbols as listed below. Symbols are enclosed by $\( and 
  888. #   ) in the string. 
  889.  
  890.     custom=
  891.  
  892. #   Specifies whether to do reverse-DNS translations of the logged IP 
  893. #   addresses, or not. Reverse-DNS translation can take some time, and 
  894. #   if you need log file data quickly, leave this disabled. Enabling 
  895. #   reverse-DNS translations will not slow- down Xitami. 
  896.  
  897.     translate=0
  898.  
  899. #   Specifies when to cycle the log file. When Xitami cycles a log 
  900. #   file, it first moves or copies the existing data to another file, 
  901. #   then creates a new, empty log file. 
  902.  
  903.     cycle=daily
  904.  
  905. #   Specifies how to cycle the log file. 
  906.  
  907.     cycle-how=rename
  908.  
  909. #   Specifies the time of day, or minute past the hour, that the log 
  910. #   file is cycled. 
  911.  
  912.     cycle-time=00:00
  913.  
  914. #   Specifies the day of the week or month that the log file is 
  915. #   cycled. 
  916.  
  917.     cycle-day=0
  918.  
  919. #   Specifies the maximum size in Kbytes for the log file; after that 
  920. #   it is cycled. 
  921.  
  922.     cycle-size=0
  923.  
  924. #   Specifies the maximum size in lines for the log file; after that 
  925. #   it is cycled. 
  926.  
  927.     cycle-lines=0
  928.  
  929. #   Specifies an argument used for the various cycle-how options. When 
  930. #   renaming a file or concatenating it onto another, Xitami uses the 
  931. #   argument as a time-stamped filename. When moving the file, Xitami 
  932. #   uses the argument as a time-stamped directory name. When 
  933. #   processing the file through an arbitrary command, it uses the 
  934. #   argument as a time-stamped command string. Xitami does not use the 
  935. #   argument when deleting log files. Format this argument from any of 
  936. #   the following timestamp fiels, mixed with other text. 
  937.  
  938.     cycle-arg=er%yy%mm%dd.log
  939.  
  940.  
  941. #   -------------------------------------------------------------------------
  942. #   DDNS configuration section
  943. #
  944. #   This section configures the Xitami dynamic DNS (DDNS) client. You 
  945. #   can define multiple DDNS registrations by duplicating this section 
  946. #   of the configuration file and naming the extra sections [Ddns1], 
  947. #   [Ddns2], etc. Xitami looks for these in order, and stops when it 
  948. #   can't find one. 
  949.  
  950. [Ddns]
  951. #   Tells Xitami whether to sign-on to the DDNS service at start-up or 
  952. #   not. This is normally switched off when you don't use DDNS and 
  953. #   switched on when you do. 
  954.  
  955.     enabled=0
  956.  
  957. #   Specifies the DDNS definition file. This is an XML file that 
  958. #   follows a specific format - look at ddnsdef.xml for an 
  959. #   explanation. If you define your own customised DDNS services, it's 
  960. #   a good idea to copy ddnsdef.xml to something else (e.g. 
  961. #   'myddnss.xml') and then change that. This avoids unpleasant 
  962. #   surprises when you upgrade your Xitami version. Note that we may 
  963. #   change the format of the DDNS definition file in the future. 
  964.  
  965.     filename=ddnsdef.xml
  966.  
  967. #   Xitami will automatically refresh its DDNS connections if you set 
  968. #   this to a non-zero value. This delay is measured in seconds. 
  969.  
  970.     refresh=3600
  971.  
  972. #   Defines the DDNS service to use. 
  973.  
  974.     service=localhost
  975.  
  976. #   Defines the dynamic domain name you are using. This must be the 
  977. #   complete domain name, for instance 'myhost.xitami.net'. 
  978.  
  979.     domain=-
  980.  
  981. #   Defines your username. Usually you define this when you register 
  982. #   your DDNS name. For Xitami.Net and tzo.com, it is an e-mail 
  983. #   address. 
  984.  
  985.     username=-
  986.  
  987. #   Defines your password. Usually you define this when you register 
  988. #   your DDNS name. For Xitami.Net and tzo.com, this is a key of the 
  989. #   form "TZO-xxxx-xxxx-xxxx-xxxx". For ns1.net, the password is sent 
  990. #   to you when you register. 
  991.  
  992.     password=-
  993.  
  994.  
  995. #   -------------------------------------------------------------------------
  996. #   RDNS configuration section
  997. #
  998. #   This section defines the configuration of the reverse-DNS lookups 
  999. #   used by Xitami to translate IP addresses for its access log files. 
  1000.  
  1001. [Rdns]
  1002. #   Defines the primary DNS server used for lookups. This value is 
  1003. #   mandatory for RDNS lookups. Specify it as an dotted IP address. 
  1004.  
  1005.     primary-server=127.0.0.1
  1006.  
  1007. #   Defines a secondary DNS server, if one is available. This will 
  1008. #   provide a backup RDNS server if the primary server does not 
  1009. #   respond. Specify it as an dotted IP address. 
  1010.  
  1011.     secondary-server=
  1012.  
  1013. #   Specifies whether Xitami uses recursive lookups or not. Depending 
  1014. #   on the DNS configuration, this can be faster or slower than 
  1015. #   non-recursive lookups. 
  1016.  
  1017.     recurse-lookups=1
  1018.  
  1019. #   Specifies whether Xitami should output trace entries for its RDNS 
  1020. #   work. If 1, each RDNS lookup sends trace information to debug.log. 
  1021. #   Use this if you are having problems getting reverse-DNS lookups to 
  1022. #   work. 
  1023.  
  1024.     debug=0
  1025.  
  1026.  
  1027. #   -------------------------------------------------------------------------
  1028. #   MIME configuration section
  1029. #
  1030. #   This section lets you define MIME types. A MIME type is 
  1031. #   information sent to the browser with each file, telling the 
  1032. #   browser how to handle the file. Specify each MIME type as a file 
  1033. #   extension and the corresponding MIME type. Note that a large set 
  1034. #   of MIME types are loaded as standard. The MIME type 'default' is 
  1035. #   used for file extensions that don't match anything else. The file 
  1036. #   extension and MIME type must be specified in lowercase. To specify 
  1037. #   a MIME type for files with no extension, use ".=xxx/xxx". 
  1038.  
  1039. [Mime]
  1040.     #   Default MIME type
  1041.     default=*/*
  1042.     #   Text MIME types
  1043.     .=text/plain
  1044.     etx=text/x-setext
  1045.     htm=text/html
  1046.     html=text/html
  1047.     htp=text/html
  1048.     rtx=text/richtext
  1049.     tsv=text/tab-separated-values
  1050.     txt=text/plain
  1051.     #   Image MIME types
  1052.     fh=image/x-freehand
  1053.     fh4=image/x-freehand
  1054.     fh5=image/x-freehand
  1055.     fh7=image/x-freehand
  1056.     fhc=image/x-freehand
  1057.     gif=image/gif
  1058.     ief=image/ief
  1059.     jpe=image/jpeg
  1060.     jpeg=image/jpeg
  1061.     jpg=image/jpeg
  1062.     pbm=image/x-portable-bitmap
  1063.     pgm=image/x-portable-graymap
  1064.     png=image/png
  1065.     pnm=image/x-portable-anymap
  1066.     ppm=image/x-portable-pixmap
  1067.     ras=image/x-cmu-raster
  1068.     rgb=image/x-rgb
  1069.     tif=image/tiff
  1070.     tiff=image/tiff
  1071.     xbm=image/x-xbitmap
  1072.     xpm=image/x-xpixmap
  1073.     xwd=image/x-xwindowdump
  1074.     #   Video MIME types
  1075.     avi=video/msvideo
  1076.     mov=video/quicktime
  1077.     movie=video/x-sgi-movie
  1078.     mpe=video/mpeg
  1079.     mpeg=video/mpeg
  1080.     mpg=video/mpeg
  1081.     qt=video/quicktime
  1082.     qtv=video/quicktime
  1083.     #   Audio MIME types
  1084.     aif=audio/x-aiff
  1085.     aifc=audio/x-aiff
  1086.     aiff=audio/x-aiff
  1087.     au=audio/basic
  1088.     m3u=audio/mpegurl
  1089.     mid=audio/midi
  1090.     mp3=audio/mpeg
  1091.     mp3url=audio/mpegurl
  1092.     ra=audio/x-realaudio
  1093.     ram=audio/x-pn-realaudio
  1094.     rm=audio/x-pn-realaudio
  1095.     rmi=audio/midi
  1096.     rpm=audio/x-pn-realaudio-plugin
  1097.     snd=audio/basic
  1098.     wav=audio/wav
  1099.     #   Application MIME types
  1100.     aab=application/x-authorware-bin
  1101.     aam=application/x-authorware-map
  1102.     aas=application/x-authorware-seg
  1103.     ai=application/postscript
  1104.     bcpio=application/x-bcpio
  1105.     bin=application/octet-stream
  1106.     cdf=application/x-netcdf
  1107.     cpio=application/x-cpio
  1108.     csh=application/x-csh
  1109.     dcr=application/x-director
  1110.     dir=application/x-director
  1111.     doc=application/msword
  1112.     dvi=application/x-dvi
  1113.     dxr=application/x-director
  1114.     eps=application/postscript
  1115.     exe=application/octet-stream
  1116.     gtar=application/x-gtar
  1117.     gz=application/x-gzip
  1118.     hdf=application/x-hdf
  1119.     jar=application/java-archive
  1120.     js=application/x-javascript
  1121.     latex=application/x-latex
  1122.     ltx=application/x-latex
  1123.     lzh=application/x-lzh
  1124.     man=application/x-troff-man
  1125.     me=application/x-troff-me
  1126.     ms=application/x-troff-ms
  1127.     nc=application/x-netcdf
  1128.     oda=application/oda
  1129.     pdf=application/pdf
  1130.     ps=application/postscript
  1131.     roff=application/x-troff
  1132.     rtf=application/rtf
  1133.     sh=application/x-sh
  1134.     shar=application/x-shar
  1135.     spl=application/futuresplash
  1136.     src=application/x-wais-source
  1137.     sv4cpio=application/x-sv4cpio
  1138.     sv4crc=application/x-sv4crc
  1139.     swf=application/x-shockwave-flash
  1140.     t=application/x-troff
  1141.     tar=application/tar
  1142.     tcl=application/x-tcl
  1143.     tex=application/x-tex
  1144.     texi=application/x-texinfo
  1145.     texinfo=application/x-texinfo
  1146.     tgz=application/x-gzip
  1147.     tr=application/x-troff
  1148.     txi=application/x-texinfo
  1149.     ustar=application/x-ustar
  1150.     zip=application/zip
  1151.     #   VRML MIME types
  1152.     wrl=x-world/x-vrml
  1153.     wrz=x-world/x-vrml
  1154.  
  1155. #   -------------------------------------------------------------------------
  1156. #   CONSOLE configuration section
  1157. #
  1158. #   This section controls the browser-based admin screens. 
  1159.  
  1160. [Console]
  1161. #   Specifies the initial screen to show; the values for this option 
  1162. #   are deliberately not documented. Change this option only using the 
  1163. #   WBA. 
  1164.  
  1165.     startup=1
  1166.  
  1167. #   Specifies whether the console information screens should refresh 
  1168. #   automatically or not. This only works with browsers that support 
  1169. #   the META HTTP-EQUIV="REFRESH" tag. On most modern browsers, the 
  1170. #   refresh option causes warning messages. 
  1171.  
  1172.     refresh=0
  1173.  
  1174. #   Specifies the rate at which the refresh occurs, in seconds. 
  1175.  
  1176.     rate=10
  1177.  
  1178. #   Specifies whether console output is sent to a file or not. 
  1179.  
  1180.     capture=1
  1181.  
  1182. #   If the capture option is set, this option specifies a filename. 
  1183.  
  1184.     filename=console.log
  1185.  
  1186. #   if the capture option is set, this option controls whether the 
  1187. #   console log is cleared each time the server is started, or not. 
  1188.  
  1189.     append=0
  1190.  
  1191. #   If 1, the WBA screens will use small amounts of JavaScript to 
  1192. #   improve the user-interface; for instance placing the cursor on the 
  1193. #   first input field automatically. If 0, JavaScript will not be 
  1194. #   used. In general enabling JavaScript will give better results. 
  1195.  
  1196.     javascript=1
  1197.  
  1198. #   If 1, the WBA screens will show large icons on the icon bar. If 0, 
  1199. #   they will show small icons with only images, no text labels. 
  1200.  
  1201.     large-icons=1
  1202.  
  1203.  
  1204. #   -------------------------------------------------------------------------
  1205. #   WIN32 configuration section
  1206. #
  1207. #   This section controls options specific to the 32-bit Windows 
  1208. #   versions of Xitami. 
  1209.  
  1210. [Win32]
  1211. #   Defines whether 16-bit CGIs are supported or not. If they are, all 
  1212. #   CGIs are run in a separate virtual machine. This is safe but slow. 
  1213. #   If you use only 32-bit CGIs, you can run CGIs faster by setting 
  1214. #   this option to 0. 
  1215.  
  1216.     16bit-cgi=0
  1217.  
  1218. #   If 1, the 'Stop', 'Start', and 'Terminate' buttons on the Xitami 
  1219. #   Windows control panel are disabled. This is intended for 
  1220. #   configurations where the server may only be halted by an 
  1221. #   authorised administrator, using the WBA control panel. 
  1222.  
  1223.     secure=0
  1224.  
  1225. #   This option is used under Windows NT for the NT service version of 
  1226. #   Xitami. You can only change this by manually editing defaults.cfg; 
  1227. #   it is not shown in the WBA. Change this before installing xiwinnt. 
  1228. #   You can use this option to install multiple instances of Xitami 
  1229. #   each with a different service name and title (as defined by the 
  1230. #   win32:service-text option). You will need a separate working 
  1231. #   directory for each such Xitami service that you start. 
  1232.  
  1233.     service-name=Xitami
  1234.  
  1235. #   This option is used under Windows NT for the NT service version of 
  1236. #   Xitami. You can only change this by manually editing defaults.cfg; 
  1237. #   it is not shown in the WBA. To enable the change, run 'xiwinnt 
  1238. #   -u', then 'xiwinnt -i'. 
  1239.  
  1240.     service-text=Xitami Web Server
  1241.  
  1242.  
  1243. #   -------------------------------------------------------------------------
  1244. #   WSX configuration section
  1245. #
  1246. #   This section lets you define web server extension (WSX) agents. An 
  1247. #   example of a WSX agent is the WBA agent. Each entry in this 
  1248. #   section defines a URL prefix and an agent name. The prefix 
  1249. #   identifies all URLs passed to this agent, and consists of one or 
  1250. #   more directory names separated by '/'. To disable a preloaded WSX 
  1251. #   agent, clear the agent name. 
  1252.  
  1253. [Wsx]
  1254.     #   Preloaded WSX agents
  1255.     .gsl=xixxml
  1256.     .map=xiimap
  1257.     .shtm=xixssi
  1258.     .shtml=xixssi
  1259.     .ssi=xixssi
  1260.     .xml=xixxml
  1261.     admin=xiadmin
  1262.     error=xierror
  1263.  
  1264. #   -------------------------------------------------------------------------
  1265. #   FTP configuration section
  1266. #
  1267. #   This section controls Xitami's FTP service. 
  1268.  
  1269. [Ftp]
  1270. #   Specifies whether the FTP service is enabled or not. If you change 
  1271. #   this, restart Xitami for the changes to take effect. 
  1272.  
  1273.     enabled=1
  1274.  
  1275. #   Specifies the root directory for FTP logins, unless a specific 
  1276. #   directory is defined for the current user. 
  1277.  
  1278.     root=./ftproot
  1279.  
  1280. #   Specifies the FTP connection port. The port is shifted by the 
  1281. #   portbase specified for the main HTTP service. For instance if you 
  1282. #   specify a port 21, and a portbase of 8000, your server will accept 
  1283. #   FTP connections on port 8021 and HTTP connections on port 8080. 
  1284.  
  1285.     port=21
  1286.  
  1287. #   Specifies the time in seconds after which inactive control 
  1288. #   connections are closed. An FTP session requires one control 
  1289. #   connection, plus one data connection during file transfers. You 
  1290. #   should tune this timeout to suit the requirements of your system. 
  1291. #   For instance, under an OS like Windows 95, sockets are a limited 
  1292. #   resource, so a shorter timeout is a good idea. For sites with a 
  1293. #   small user group, you can use high timeouts, which users generally 
  1294. #   prefer. 
  1295.  
  1296.     timeout=300
  1297.  
  1298. #   Specifies the maximum number of users that may login at once. On 
  1299. #   systems that can handle lots of open sockets (e.g. Unix, OS/2, 
  1300. #   WinNT, Win98), you may want to increase this. Xitami does not 
  1301. #   impose any fixed limit. If you set this value to 0, it means 'no 
  1302. #   limit'. 
  1303.  
  1304.     limit=25
  1305.  
  1306. #   Specifies the default FTP throttle pipe. With a throttle pipe you 
  1307. #   can restrict the throughput of a FTP site to some fixed maximum, 
  1308. #   e.g. 64Kbps. This can be useful if several FTP sites share a 
  1309. #   single line, and you need to share this on a quality-of-service 
  1310. #   basis. The FTP throttle pipe is used for uploads and downloads for 
  1311. #   the FTP service, except where the profile for a user specifies a 
  1312. #   different throttle pipe. Pipes are defined in the XML file 
  1313. #   'pipedef.xml'. You can edit this file to add new pipes; Xitami 
  1314. #   reloads this automatically after a short delay. Each pipe is 
  1315. #   defined as several 'instances', which are simply individual pipes 
  1316. #   that share the same characteristics. For example, the default 
  1317. #   pipedef.xml file defines several pipes with a 64Kbps throughput. 
  1318. #   These are individual instances of a 64Kpbs pipe. All transfers 
  1319. #   that use a specific pipe instance share the bandwidth of that pipe 
  1320. #   instance. 
  1321.  
  1322.     pipe=
  1323.  
  1324. #   Specifies the name of the FTP user definition file. 
  1325.  
  1326.     user-file=ftpusers.aut
  1327.  
  1328. #   Specifies the name of the directory definition file. 
  1329.  
  1330.     directory-file=ftpdirs.aut
  1331.  
  1332. #   Specifies the sort order for directory listings. You can sort by 
  1333. #   file name, extension, size, or modification date/time using any 
  1334. #   combination of the letters 'n', 'x', 's', and 't'. For instance, 
  1335. #   dirsort=xnt will sort by extension, then name, then time. To sort 
  1336. #   in reverse order, use capital letters. For instance to show the 
  1337. #   most recent files first, use dirsort=T. 
  1338.  
  1339.     dirsort=n
  1340.  
  1341. #   Specifies the GSL script that is used to format FTP messages. If 
  1342. #   you use this option, Xitami ignores the welcome, signoff, and 
  1343. #   login-text options. GSL is a scripting language used by the iMatix 
  1344. #   GSLgen tool, incorporated into Xitami. A GSL script is a flexible 
  1345. #   way to format output texts - see the supplied script for more 
  1346. #   information. It's a good idea, if you change this script, to copy 
  1347. #   it and change the copy. Otherwise your changes will probably be 
  1348. #   lost when/if you ever upgrade your Xitami installation. 
  1349.  
  1350.     message-script=templates/ftpmesg.gsl
  1351.  
  1352. #   Specifies a text to be shown when a user connects to the FTP 
  1353. #   server. This can be literal text, or the name of a file, preceded 
  1354. #   by '@'. The file can contain up to 2000 characters. Any lines that 
  1355. #   start with '#' are ignored as comments. If you modify this file, 
  1356. #   it is safest to make a copy (call it welcome.txt or something) and 
  1357. #   change this option to refer to the changed file. This avoids 
  1358. #   unpleasant surprises when you reinstall the next latest greatest 
  1359. #   version of Xitami. 
  1360.  
  1361.     welcome=@ftphello.txt
  1362.  
  1363. #   Specifies a text to be shown when a user ends the FTP session. 
  1364. #   This can be literal text, or the name of a file, preceded by '@'. 
  1365. #   The file can contain up to 2000 characters. Any lines that start 
  1366. #   with '#' are ignored as comments. If you modify this file, it is 
  1367. #   safest to make a copy (call it goodbye.txt or something) and 
  1368. #   change this option to refer to the changed file. This avoids 
  1369. #   unpleasant surprises when you reinstall the next latest greatest 
  1370. #   version of Xitami. 
  1371.  
  1372.     signoff=@ftpadios.txt
  1373.  
  1374. #   Specifies a text to be shown when a user logs-in to the FTP 
  1375. #   server. This can be literal text, or the name of a file, preceded 
  1376. #   by '@'. The file can contain up to 2000 characters. Any lines that 
  1377. #   start with '#' are ignored as comments. If you modify this file, 
  1378. #   it is safest to make a copy (call it login.txt or something) and 
  1379. #   change this option to refer to the changed file. Xitami will 
  1380. #   search for this file first in the user's login directory, then in 
  1381. #   the main Xitami directory. 
  1382.  
  1383.     login-text=@ftplogin.txt
  1384.  
  1385. #   This flag controls whether Xitami allows virtual hosts using the 
  1386. #   syntax 'username@hostname'. This syntax is supported by some FTP 
  1387. #   clients, and allows you to use multiple FTP virtual hosts on a 
  1388. #   single IP address. 
  1389.  
  1390.     user-at-host=1
  1391.  
  1392. #   If 1, the FTP server will check that the e-mail address supplied 
  1393. #   for anonymous logins is a valid address. The nature of the check 
  1394. #   is not documented (it may just look for an '@' in the address). 
  1395.  
  1396.     email-check=0
  1397.  
  1398. #   Specifies whether the HTTP [Alias] section should be used by the 
  1399. #   FTP service. This can be useful in configurations where you want 
  1400. #   to share the same data between services, but it can be a security 
  1401. #   risk if you want to use FTP aliases to access directories outside 
  1402. #   the HTTP space. 
  1403.  
  1404.     http-aliases=0
  1405.  
  1406. #   Specifies the default soft quota for FTP users who are subject to 
  1407. #   a quota. You can also specify quota values for individual users. 
  1408. #   This value is specified in megabytes, as a decimal number (using a 
  1409. #   decimal point, not comma, even in Europe). When a user exceeds 
  1410. #   their soft quota, they start getting warning messages. 
  1411.  
  1412.     soft-quota=2.5
  1413.  
  1414. #   Specifies the default hard quota for FTP users who are subject to 
  1415. #   a quota. You can also specify quota values for individual users. 
  1416. #   This value is specified in megabytes, as a decimal number. When a 
  1417. #   user exceeds their hard quota, they cannot upload new files. 
  1418.  
  1419.     hard-quota=5
  1420.  
  1421. #   Specifies the set of clients that can connect to the FTP server. 
  1422. #   Use 'webmask=local' to specify just local addresses, or 
  1423. #   'webmask=item,item,...' to specify one or more types of access. 
  1424. #   Each item allows or excludes some IP address(es): '250.12.13.*' 
  1425. #   allows matching addresses, '!250.12.13.*' excludes matching 
  1426. #   addresses (but does not allow others). '!250.12.13.*,*' excludes 
  1427. #   one set of addresses and allows all others. 'webmask=@iplist.txt' 
  1428. #   reads the list of webmasks from a text file. 
  1429.  
  1430.     webmask=*
  1431.  
  1432. #   If 1, FTP passwords are case-sensitive. If 0, passwords are always 
  1433. #   converted to lower-case before validation. If you set this to 0, 
  1434. #   be sure to use only lower-case passwords in the password file. 
  1435.  
  1436.     password-case=1
  1437.  
  1438. #   Specifies the port at which data connections will be made. Xitami 
  1439. #   scans for free ports, so this is simply the start of a range of 
  1440. #   ports. The port is shifted by whatever value was used for the 
  1441. #   server portbase. 
  1442.  
  1443.     data-port=200
  1444.  
  1445. #   Indicates whether passive connections must be forced to the IP 
  1446. #   address specified in the 'ipaddress' option. 
  1447.  
  1448.     force-ip=0
  1449.  
  1450. #   The IP address used for passive connections. If '*', accepts 
  1451. #   passive connections on all local available IP addresses. 
  1452.  
  1453.     ipaddress=*
  1454.  
  1455.  
  1456. #   -------------------------------------------------------------------------
  1457. #   FTP-ALIAS configuration section
  1458. #
  1459. #   This section lets you define FTP aliases. An FTP alias looks like 
  1460. #   a root directory for ftp users, and point to some arbitrary 
  1461. #   directory on the server.+ The alias name itself may not contain 
  1462. #   '/'. It is not case sensitive. FTP aliases are only shown to 
  1463. #   'root' users, i.e. those with an empty root value, or those who 
  1464. #   have the 'aliases=1' option defined. Aliases are shown only if the 
  1465. #   user has GET access, and if the specified user's root directory 
  1466. #   actually exists. 
  1467.  
  1468. [Ftp-Alias]
  1469.  
  1470. #   -------------------------------------------------------------------------
  1471. #   FTPLOG configuration section
  1472. #
  1473. #   This section controls the server access log, recording FTP hits. 
  1474.  
  1475. [Ftplog]
  1476. #   Specifies whether logging is enabled or not. 
  1477.  
  1478.     enabled=1
  1479.  
  1480. #   Specifies the name of the log file. 
  1481.  
  1482.     filename=access.log
  1483.  
  1484. #   Specifies whether to include local addresses or not. 
  1485.  
  1486.     local=1
  1487.  
  1488. #   Specifies the log file format. The log file format you use needs 
  1489. #   to be compatible with whatever tool you use to analyze log files 
  1490. #   and build statistics. The most common tools work with an extended 
  1491. #   form of the NCSA log file format, also called 'common log file 
  1492. #   format'. We call this "CLFX". An other commonly-used format is 
  1493. #   that produced by Microsoft web servers. Xitami also creates log 
  1494. #   files in two XML formats, which you can easily process using 
  1495. #   GSLgen to you create arbitrary reports, statistics, and HTML 
  1496. #   analyses. Lastly, you can create your own format, for specific 
  1497. #   purposes. Impressed? We are... :-) 
  1498.  
  1499.     format=CLFX
  1500.  
  1501. #   Custom log file format. This is an arbitrary text string that 
  1502. #   contains symbols as listed below. Symbols are enclosed by $\( and 
  1503. #   ) in the string. 
  1504.  
  1505.     custom=
  1506.  
  1507. #   Specifies whether to do reverse-DNS translations of the logged IP 
  1508. #   addresses, or not. Reverse-DNS translation can take some time, and 
  1509. #   if you need log file data quickly, leave this disabled. Enabling 
  1510. #   reverse-DNS translations will not slow- down Xitami. 
  1511.  
  1512.     translate=0
  1513.  
  1514. #   Specifies when to cycle the log file. When Xitami cycles a log 
  1515. #   file, it first moves or copies the existing data to another file, 
  1516. #   then creates a new, empty log file. 
  1517.  
  1518.     cycle=daily
  1519.  
  1520. #   Specifies how to cycle the log file. 
  1521.  
  1522.     cycle-how=rename
  1523.  
  1524. #   Specifies the time of day, or minute past the hour, that the log 
  1525. #   file is cycled. 
  1526.  
  1527.     cycle-time=00:00
  1528.  
  1529. #   Specifies the day of the week or month that the log file is 
  1530. #   cycled. 
  1531.  
  1532.     cycle-day=0
  1533.  
  1534. #   Specifies the maximum size in Kbytes for the log file; after that 
  1535. #   it is cycled. 
  1536.  
  1537.     cycle-size=0
  1538.  
  1539. #   Specifies the maximum size in lines for the log file; after that 
  1540. #   it is cycled. 
  1541.  
  1542.     cycle-lines=0
  1543.  
  1544. #   Specifies an argument used for the various cycle-how options. When 
  1545. #   renaming a file or concatenating it onto another, Xitami uses the 
  1546. #   argument as a time-stamped filename. When moving the file, Xitami 
  1547. #   uses the argument as a time-stamped directory name. When 
  1548. #   processing the file through an arbitrary command, it uses the 
  1549. #   argument as a time-stamped command string. Xitami does not use the 
  1550. #   argument when deleting log files. Format this argument from any of 
  1551. #   the following timestamp fiels, mixed with other text. 
  1552.  
  1553.     cycle-arg=ac%yy%mm%dd.log
  1554.  
  1555.  
  1556. #   -------------------------------------------------------------------------
  1557. #   FTPERRLOG configuration section
  1558. #
  1559. #   This section controls the FTP error log. 
  1560.  
  1561. [Ftperrlog]
  1562. #   Specifies whether logging is enabled or not. 
  1563.  
  1564.     enabled=1
  1565.  
  1566. #   Specifies the name of the log file. 
  1567.  
  1568.     filename=errors.log
  1569.  
  1570. #   Specifies whether to include local addresses or not. 
  1571.  
  1572.     local=1
  1573.  
  1574. #   Specifies the log file format. The log file format you use needs 
  1575. #   to be compatible with whatever tool you use to analyze log files 
  1576. #   and build statistics. The most common tools work with an extended 
  1577. #   form of the NCSA log file format, also called 'common log file 
  1578. #   format'. We call this "CLFX". An other commonly-used format is 
  1579. #   that produced by Microsoft web servers. Xitami also creates log 
  1580. #   files in two XML formats, which you can easily process using 
  1581. #   GSLgen to you create arbitrary reports, statistics, and HTML 
  1582. #   analyses. Lastly, you can create your own format, for specific 
  1583. #   purposes. Impressed? We are... :-) 
  1584.  
  1585.     format=CLFX
  1586.  
  1587. #   Custom log file format. This is an arbitrary text string that 
  1588. #   contains symbols as listed below. Symbols are enclosed by $\( and 
  1589. #   ) in the string. 
  1590.  
  1591.     custom=
  1592.  
  1593. #   Specifies whether to do reverse-DNS translations of the logged IP 
  1594. #   addresses, or not. Reverse-DNS translation can take some time, and 
  1595. #   if you need log file data quickly, leave this disabled. Enabling 
  1596. #   reverse-DNS translations will not slow- down Xitami. 
  1597.  
  1598.     translate=0
  1599.  
  1600. #   Specifies when to cycle the log file. When Xitami cycles a log 
  1601. #   file, it first moves or copies the existing data to another file, 
  1602. #   then creates a new, empty log file. 
  1603.  
  1604.     cycle=daily
  1605.  
  1606. #   Specifies how to cycle the log file. 
  1607.  
  1608.     cycle-how=rename
  1609.  
  1610. #   Specifies the time of day, or minute past the hour, that the log 
  1611. #   file is cycled. 
  1612.  
  1613.     cycle-time=00:00
  1614.  
  1615. #   Specifies the day of the week or month that the log file is 
  1616. #   cycled. 
  1617.  
  1618.     cycle-day=0
  1619.  
  1620. #   Specifies the maximum size in Kbytes for the log file; after that 
  1621. #   it is cycled. 
  1622.  
  1623.     cycle-size=0
  1624.  
  1625. #   Specifies the maximum size in lines for the log file; after that 
  1626. #   it is cycled. 
  1627.  
  1628.     cycle-lines=0
  1629.  
  1630. #   Specifies an argument used for the various cycle-how options. When 
  1631. #   renaming a file or concatenating it onto another, Xitami uses the 
  1632. #   argument as a time-stamped filename. When moving the file, Xitami 
  1633. #   uses the argument as a time-stamped directory name. When 
  1634. #   processing the file through an arbitrary command, it uses the 
  1635. #   argument as a time-stamped command string. Xitami does not use the 
  1636. #   argument when deleting log files. Format this argument from any of 
  1637. #   the following timestamp fiels, mixed with other text. 
  1638.  
  1639.     cycle-arg=er%yy%mm%dd.log
  1640.  
  1641.  
  1642. #   -------------------------------------------------------------------------
  1643. #   LRWP configuration section
  1644. #
  1645. #   This section controls the LRWP (long-running web process) 
  1646. #   protocol. 
  1647.  
  1648. [Lrwp]
  1649. #   Specifies whether the LRWP agent is enabled or not. 
  1650.  
  1651.     enabled=1
  1652.  
  1653. #   Specifies the port on which the LRWP agent accepts connections. 
  1654.  
  1655.     port=81
  1656.  
  1657. #   Specifies the webmask for LRWP clients. Normally this is 
  1658. #   restricted to local LRWP clients, but you can also construct LRWP 
  1659. #   networks from multiple servers. Use 'webmask=local' to specify 
  1660. #   just local addresses, or 'webmask=item,item,...' to specify one or 
  1661. #   more types of access. Each item allows or excludes some IP 
  1662. #   address(es): '250.12.13.*' allows matching addresses, 
  1663. #   '!250.12.13.*' excludes matching addresses (but does not allow 
  1664. #   others). '!250.12.13.*,*' excludes one set of addresses and allows 
  1665. #   all others. 'webmask=@iplist.txt' reads the list of webmasks from 
  1666. #   a text file. 
  1667.  
  1668.     webmask=local
  1669.  
  1670. #   Allows all LRWP clients to connect. If this is set to 1, any LRWP 
  1671. #   application will be allowed to connect. Otherwise the 
  1672. #   LRWP-Application section must be used to authorise specific 
  1673. #   applications, and optionally specify a password to use during the 
  1674. #   authentication stage. 
  1675.  
  1676.     allow-all=1
  1677.  
  1678.  
  1679. #   -------------------------------------------------------------------------
  1680. #   LRWP-APPLICATION configuration section
  1681. #
  1682. #   This section consists of one entry per application name (either 
  1683. #   URL prefix, or a URL "extension" name). The entry should either to 
  1684. #   be set to "*" to indicate the application is allowed without 
  1685. #   authentication, or to a password/phrase that is used in LRWP 2.0 
  1686. #   authentication with that application. If a password/phrase is 
  1687. #   specified, then LRWP 1.0 clients will not be allowed to connect 
  1688. #   with that name (as they cannot perform the required 
  1689. #   authentication). 
  1690.  
  1691. [Lrwp-Application]
  1692.  
  1693. #   -------------------------------------------------------------------------
  1694. #   SSL-HTTP configuration section
  1695. #
  1696. #   This section controls the interface between Xitami and the SSL 
  1697. #   (secure socket layer) agent. The SSL agent is active in 
  1698. #   Xitami/Pro, the professional version of Xitami. 
  1699.  
  1700. [Ssl-Http]
  1701. #   Specifies whether the SSL interface is enabled or not. 
  1702.  
  1703.     enabled=1
  1704.  
  1705. #   Specifies the SSL configuration filename. 
  1706.  
  1707.     config-file=sslhttp.cfs
  1708.  
  1709.  
  1710.